Skip to main content

מפרט עסקי - שירות סטטוס בקשות

רעיון השירות​

שירות סטטוס בקשות הוא מערכת שמאפשרת לאזרחים לעקוב אחר מצב הבקשות שלהם ברשויות המקומיות. המערכת פועלת כגשר בין האזרח לבין מערכות המידע של הרשויות, ומאפשרת קבלת מידע מפורט על סטטוס בקשות, התקדמות עיבוד ופרטים נוספים.

מטרה עיקרית​

השירות מאפשר לאזרחים לקבל מידע מלא ומעודכן על:

  • סטטוס בקשות שלהם ברשויות המקומיות
  • התקדמות עיבוד של כל בקשה
  • פרטי בקשה - מספר תיק, תאריך יצירה, סוג בקשה
  • מסמכים חסרים או נדרשים
  • קישורים רלוונטיים למידע נוסף

שירותים עיקריים​

1. מעקב אחר בקשות​

השירות מאפשר לעקוב אחר בקשות שונות:

  • חילופי מחזיקים - בקשות לחילוף דיירים בנכסים
  • הנחה בארנונה - בקשות להנחות ארנונה
  • תו חניה - בקשות לתווי חניה

2. הצגת סטטוס מפורט​

השירות מציג מידע מפורט על כל בקשה:

  • מספר תיק - מזהה ייחודי לכל בקשה
  • מספר הפניה - מספר הפניה של הרשות
  • סוג בקשה - סוג הבקשה שהוגשה
  • תאריך יצירה - מתי הבקשה נוצרה
  • תאריך עדכון - מתי הסטטוס עודכן לאחרונה

3. מידע על התקדמות​

השירות מספק מידע על התקדמות העיבוד:

  • כותרת סטטוס - כותרת המצב הנוכחי
  • תיאור סטטוס - תיאור מפורט של המצב
  • הערות - הערות נוספות על הבקשה
  • מסמכים חסרים - רשימת מסמכים שחסרים

4. קישורים ופעולות​

השירות מספק קישורים ופעולות נוספות:

  • קישור למידע נוסף - קישור למידע מפורט
  • פעולות זמינות - פעולות שניתן לבצע על הבקשה

מפרט טכני - שירות סטטוס בקשות

מודולים ושירותים קיימים​

1. RequestStatusService (libs/request-status/src/request-status.service.ts)​

תפקיד: עיבוד לוגיקה עסקית וחיבור למערכות חיצוניות פונקציות עיקריות:

  • getRequestStatus() - קבלת סטטוס בקשות עבור משתמש ורשות

2. RequestStatusController (libs/request-status/src/request-status.service.controller.ts)​

תפקיד: מטפל בבקשות HTTP ומחזיר תשובות Endpoints זמינים:

  • POST /api/v1/request_status - קבלת סטטוס בקשות

3. RequestStatusModule (libs/request-status/src/request-status.module.ts)​

תפקיד: הגדרת המודול והתלויות תלויות:

  • SupplierAuthServiceModule - לחיבור לספקים
  • RbacModule - לניהול הרשאות
  • MunicipalitiesModule - לניהול רשויות

מבני נתונים (JSON)​

בקשה (Request)​

{
  "tz": "123456789",
  "municipality_code": "001"
}

תשובה (Response) - RequestsStatusResponseDto​

{
  "error_code": 0,
  "message": "Success",
  "municipalityCode": 1,
  "tz": "123456789",
  "requests": [
    {
      "municipalFormId": "FORM123456",
      "referenceNumber": "REF789012",
      "formCategory": "חילופי מחזיקים",
      "createDate": "2024-01-15T10:30:00Z",
      "statusDate": "2024-01-20T14:45:00Z",
      "objectTypeCode": 1,
      "objectTypeDescription": "דירה",
      "statusTitle": "בטיפול",
      "statusText": "הבקשה נמצאת בטיפול במחלקת הרישום",
      "notes": "נדרש מסמך נוסף",
      "missingDocuments": "תעודת זהות מעודכנת",
      "link": "https://example.com/request/123456"
    }
  ]
}

מבנה בקשה (RequestDto)​

{
  "municipalFormId": "string",
  "referenceNumber": "string",
  "formCategory": "string",
  "createDate": "string",
  "statusDate": "string",
  "objectTypeCode": "number",
  "objectTypeDescription": "string",
  "statusTitle": "string",
  "statusText": "string",
  "notes": "string",
  "missingDocuments": "string",
  "link": "string"
}

חיבורים למערכות חיצוניות​

איך החיבור עובד?​

  1. אימות רשות - בדיקה שהרשות קיימת ופעילה
  2. אימות ספק - בדיקה שיש ספק מטפל בשירות
  3. שליחת בקשה - העברת פרטי המשתמש לרשות
  4. קבלת נתונים - קבלת רשימת בקשות וסטטוסים
  5. עיבוד נתונים - המרת קודי סוג בקשה לעברית
  6. החזרת תשובה - החזרת מידע מעובד למשתמש

מיפוי סוגי בקשות​

השירות ממיר קודי סוג בקשה לעברית:

  • 1 → "חילופי מחזיקים"
  • 2 → "הנחה בארנונה"
  • 3 → "תו חניה"

תלויות חיצוניות​

  • MunicipalitiesService - לניהול רשויות
  • SupplierAuthServiceService - לחיבור לספקים
  • RbacGuard - לאימות משתמשים

Issues / Missing parts

בעיות קוד קיימות​

1. שם Controller שגוי​

מיקום: libs/request-status/src/request-status.service.controller.ts שורה 12

export class DeltaBtlController { // ← בעיה: שם שגוי, צריך להיות RequestStatusController

2. חיבורים חסרים​

  • חיבור לביטוח לאומי - לא מיושם
  • חיבור לספקים נוספים - רק ספק אחד קיים
  • ממשקי OneCity - לא מיושמים

חלקים שחסרים​

1. ממשקי OneCity​

  • ממשק GET - לא קיים
  • ממשק POST - לא קיים

2. חיבור לביטוח לאומי​

  • ייבוא נתונים - לא מיושם
  • עיבוד נתוני זכאות - לא קיים

3. אפליקציית ניהול​

  • תיקונים סמנטיים - לא מושלמים
  • ממשק ניהול - לא קיים

4. בדיקות איכות​

  • בדיקות יחידה - לא מושלמות
  • בדיקות אינטגרציה - לא קיימות

5. תיעוד API​

  • Swagger מלא - לא קיים
  • תיעוד מפורט - לא קיים

6. ממשק משתמש​

  • ממשק משתמש - לא קיים
  • דפי ניהול - לא קיימים

המלצות לתיקון​

1. תיקון מיידי​

  • תיקון שם Controller - שינוי מ-DeltaBtlController ל-RequestStatusController
  • הוספת בדיקות שגיאות - טיפול במקרים של כשל
  • שיפור תיעוד API - הוספת Swagger מפורט

2. פיתוח עתידי​

  • יישום ממשקי OneCity - לפי המפרט
  • השלמת אפליקציית ניהול - עד השבוע הבא
  • הוספת בדיקות איכות - לפני העברה לייצור
  • פיתוח ממשק משתמש - לניהול סטטוס בקשות